본문으로 건너뛰기

7.1.1 MINPAY 지갑 결제 주문 생성

#간략한 설명: MINPAY 지갑 스캔 코드 RMB 충전 비즈니스 인터페이스. 사용자는 QR 코드를 스캔하여 지갑 계정에 CNY 충전을 완료할 수 있습니다.

요청 매개변수​
매개변수 이름유형필수매개변수 의미매개변수 설명
keystring예판매자 키API키
localOrderIdstring예판매자 플랫폼 현지 주문 번호판매자 플랫폼은 로컬에서 고유한 주문 번호를 생성합니다
localUserIdstring아니요판매자 플랫폼 로컬 사용자 ID판매자 플랫폼 로컬 사용자 ID
amountnumber예결제금액주문금액
notifyUrlstring예콜백 주소주문이 성공적으로 완료되면 API 콜백을 통해 판매자의 주소가 통보됩니다.| (콜백 내용은 문서 3 참조)
successRedirectUrlstring아니요주소성공 후 해당 주소로 자동 점프
currencystring예통화 주문주문 통화(지갑 지원 통화)
expireSecondLong아니요만료 타임스탬프(초)
signstring예서명자세한 내용은 서명 알고리즘을 참조하세요.
json 샘플 요청​
{
  "key": "dNNTJZpgFVWlYrVv",
  "localOrderId": "173322",
  "notifyUrl": "http://127.0.0.1:8080/merchant-demo/notify",
  "amount": 1,
  "currency": "USDT",
  "sign": "7f07092874886179997617567a98e20e"
}

응답 JSON 예시

{
  "code": 0,
  "success": true,
  "message": null,
  "data": {
    "orderId": "273719658252609",
    "localUserId": null,
    "localOrderId": "173322",
    "orderType": "PAYMENT",
    "orderBizType": "PAYMENT_WALLET_SCAN",
    "paymentUrl": "https://walletapi.vapyapp.com/scan-pay/JJB7BvCtyxP3ieKk1pBpxnTposMtF4nvixsjdHCu7X8KEukfzB5h3bGa88Ke",
    "publicKey": "JJB7BvCtyxP3ieKk1pBpxnTposMtF4nvixsjdHCu7X8KEukfzB5h3bGa88Ke"
  }
}

반환된 PaymentUrl은 아래와 같이 결제 페이지를 팝업으로 표시합니다.

![img](/dx-docs/7- 7、数字币代收（充值）/7.1 MINPAY钱包扫码支付/wallet.jpg)

응답 데이터 매개변수 설명​
매개변수 이름유형매개변수 의미매개변수 설명
orderIdstring주문번호
localUserIdstring판매자 ID
localOrderIdstring판매자 지역 주문 번호
orderTypeenum주문 유형PAYMENT:支付订单 ｜ WITHDRA:提款订单
orderBizTypeenum주문사업orderBizType 유형 설명은 다음과 같습니다.
paymentUrlstring주소지불 주소
publicKeystring비밀 키공개 액세스 키

orderBizType 유형 설명:​

  1. PAYMENT_WALLET_SCAN MINPAY 지갑 스캔코드 결제
  2. PAYMENT_TRANSFER 디지털 화폐 바인딩 주소 직접 입금
  3. PAYMENT_ANY_DIGITAL_SCAN QR 코드를 스캔하여 원하는 금액의 디지털 화폐를 결제하세요.
  4. WITHDRAW_WALLET MINPAY 지갑으로 돈을 인출하세요.
  5. WITHDRAW_ANY_DIGITAL_WALLET 디지털 통화를 지갑으로 인출하세요.
  6. PAYMENT_FIXED_DIGITAL_SCAN 디지털화폐 한도금액 스캔코드 결제
  7. BATCH_PAY 일괄결제

콜백은 json 데이터를 반환합니다​

기본적으로 모든 콜백 매개변수는 서명 확인에 참여합니다. 콜백 매개변수에 대한 자세한 내용은 콜백 ]를 참조하세요.

콜백 데이터​
{
  "amount": 11,
  "bizType": "PAYMENT_FIXED_DIGITAL_SCAN",
  "currency": "CNY",
  "key": "h3cS7dBltRU4W1wD",
  "localOrderId": "2820",
  "merchantActualAmount": 8.86,
  "merchantCurrency": "CNY",
  "merchantId": 303122065665,
  "merchantPaidAmount": 10.98,
  "merchantUserId": "97",
  "notifyTime": 1731572168370,
  "orderCreateTime": 1731572133082,
  "orderId": "273124814912907",
  "sign": "699806308a9e055114c378671b0d2a15",
  "status": "SUCCESS",
  "type": "PAYMENT",
  "userAmount": 1.55,
  "userCurrency": "USDT"
}

콜백 알림을 받으면 처리가 완료된 후 메시지가 성공적으로 수신 및 처리되었음을 나타내는 성공 문자열을 직접 반환해 주세요. 시스템이 성공 응답을 받은 후에는 더 이상 콜백을 반복적으로 보내지 않습니다. 예상된 응답을 받지 못한 경우(성공이 반환되지 않거나 예외가 반환됨) 시스템은 단계적 재시도 메커니즘에 따라 최대 14회 재시도하여 콜백 알림을 다시 보냅니다. 현재 재시도 간격은 다음과 같습니다. 15대, 15대, 30대, 180년대, 600년대, 1200년대, 1800년대, 1800년대, 1800년대, 3600년대, 10800년대, 10800년대, 21600년대, 21600년대